<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">

<head>
<meta http-equiv="Content-Language" content="en-us">
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Group Launch Configuration</title>
<link rel="stylesheet" type="text/css" href="../help.css">
</head>
<body>

<div role="main"><h1>Launch Group</h1>

<p>The user can launch multiple applications at the same time or in sequential order. This is made possible by the launch configuration type: <em>Launch Group</em>.</p>

<h2>Launches tab</h2>
<p>

The <em>Launches</em> tab lets you add and delete launch configurations to the group.
It also allows you to temporarily disable, re-order and edit properties of the elements in the group.

</p>
<img src="../images/run_debug_launch_group.png" alt="Run Configuration dialog, Launch group">
<p></p>

<table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" >
<tr ><th id="component">Component</th><th id="description">Description</th></tr>
<tr><td style="width:30%" headers="component"><strong>Name</strong></td><td headers="description">Displays the name of the launch configuration and a checkbox for enabling or disabling the configuration.</td></tr>
<tr><td headers="component"><strong>Mode</strong></td><td headers="description">Displays the mode the configuration will run in when the group is launched.</td></tr>
<tr><td headers="component"><strong>Action</strong></td><td headers="description">Displays the optional action that will be carried after the configuration is launched.</td></tr>
<tr><td headers="component"><strong>Up</strong></td><td headers="description">Move selected configuration(s) up</td></tr>
<tr><td headers="component"><strong>Down</strong></td><td headers="description">Move selected configuration(s) down</td></tr>
<tr><td headers="component"><strong>Add...</strong></td><td headers="description">Opens a dialog to add a new configuration.</td></tr>
<tr><td headers="component"><strong>Edit...</strong></td><td headers="description">Opens a dialog to edit values for configuration(s).</td></tr>
<tr><td headers="component"><strong>Remove</strong></td><td headers="description">Removes selected configuration(s) from the list.</td></tr>

</table>


<h2>Common tab</h2>

The <em>Common</em> tab lets you select where the configuration is stored, see <a href="cdt_u_run_dbg_comm.htm">Common tab reference</a> page for details.

<h2>Add and Edit launch configuration Dialog</h2>
<p>
<img src="../images/run_debug_launch_group_edit.png"  alt="Edit Launch Configuration dialog">
</p>

<table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" >
<tr ><th id="component2">Component</th><th id="description2">Description</th></tr>
<tr><td style="width:30%" headers="component2"><strong>Launch Mode</strong></td>
  <td headers="description2">The Launch Mode combobox at the top of the dialog serves a dual purpose.
  <ol>
  <li>
   It dictates the desired mode for the launch configuration being added,
and </li>
<li>
   It establishes a 'mode' filter for the launch configurations that are
exposed to the user (for selection) in the area below the combobox
</li>
</ol>
<p>
For example, when the 'debug' mode is selected, (1) only launch configurations
that support being invoked in 'debug' mode appear. Also, (2) when the launch
group is invoked, that particular child launch configuration will be invoked in
'debug' mode.
  </td></tr>
<tr><td headers="component2"><strong>Filter input</strong></td><td headers="description2">Type in filter input to filter list of configurations by name</td></tr>
<tr><td headers="component2"><strong>Configurations tree</strong></td><td headers="description2">Lists all available launch configurations for the selected Launch Mode, filtered by <em>Filter input</em>.</td></tr>
<tr><td headers="component2"><strong>Use default mode when launching</strong></td>
  <td headers="description2">
This checkbox acts as a sort of override to whatever mode is set in the Launch Mode
combobox. Checking this option indicates that the child launch configuration
should be launched in the mode used to initiate the launch group launch. This
needs some clarification. First, realize that a launch configuration can be
invoked from either the 'Debug' or the 'Run' actions (and some comparable
'profile' action in certain Eclipse configurations/products). That means, the
launch group itself can be launched either in debug or run mode. When you check
the <q>Use default...</q> checkbox, you're saying: <q>launch this particular child
configuration in the mode that the parent (launch group) is launched with.</q> If
you do not have that checkbox checked, then the child configurations will be
invoked in whatever mode each individual child is configured with.
<p>
Note that <q>Use default...</q> control can allow you to create a launch group
that will not be successful. For example when one or more launch configurations
selected cannot be launched in the mode dictated by launch group mode.
  </td></tr>
<tr><td headers="component2"><strong>Post launch action</strong></td><td headers="description2">
There are several actions available that control what should be done after each launch:
<ul>
<li>Delay - Waits a specified number of second before launching the next configuration in the group</li>
<li>Wait until terminated - Waits until current launch is terminated</li>
<li>None - Proceeds to launch next configuration immediately</li>
</ul>
</td></tr>

</table>



<p>





<p><img src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
<br>
<a href="../concepts/cdt_c_over_dbg.htm">Debug overview</a><br>
<a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p>
<p><img src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
<br>
<a href="../tasks/cdt_o_run.htm">Running and debugging</a></p>
<p><img src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
<br>
<a href="cdt_o_run_dbg_pages.htm">Run and Debug dialog box</a></p>
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >

</div></body>

</html>
